FL Studio FLP file format 
(version 11.x) 


How it works 

The FLP format is loosely based on MIDI and AIFF files. Apart from the header, it's just a 
succession of events. Once you understand how to process the file to retrieve these events, 
the only thing you'll need is the list of events available. 

Please note that the format *does not* respect the AIFF standard completely, but it's similar. 
DWORD is 4 bytes, WORD is 2 bytes, BYTE is 1 byte. 

TEXT is a sequence of characters. Up to and including version 11, these were single-byte ansi 


characters. From version 12 on, these are 2-byte unicode characters. The exception is the 
FLP Version event, which remains ansi (for compatibility). 


Retrieving the events 


While it looks like a MIDI file, it's not really a MIDI file. 


First, you'll have to get & check the HEADER chunk, to be sure it's an FLP file. 
The header is similar to the format of a MIDI file header: 


DWORD ChunkID 4 chars which are the letters 'FLhd' for 'FruityLoops header' 
DWORD Length The length of this chunk, like in MIDI files. Atm it's 6, but 
could evolve. 

WORD Format Set to 0 for full songs. 

WORD nChannels The total number of channels (not really used). 

WORD BeatDiv Pulses per quarter of the song. 


Then you'll encounter the DATA chunk, which is in fact the last chunk, the one containing all 
the events. 


DWORD ChunkID 4 chars which are the letters 'FLdt' for 'FruityLoops data' 
DWORD Length The length of (the rest of) this chunk (i.e. WITHOUT these 
2 DWORDS) 


The whole data chunk is a succession of EVENTS, which I'm going to explain... 


To retrieve an event, first you read a byte (the event ID). According to this byte, the size of 
the event data varies: 

0..63 The data after this byte is a BYTE (signed or unsigned, depending on the ID). 
64..127 The data after this byte is a WORD. 

128..191 The data after this byte is a DWORD. 

192..255 The data after this byte is a variable-length block of data (a text for example). 


That makes 64 BYTE events, 64 WORD events, 64 DWORD events & 64 TEXT events. The 
purpose of this split is of course to keep the file size small. 

So you get the event ID & then you read the number of bytes according to this ID. Whether 
you process the event or not isn't important. What is important is that you can jump correctly 
to the next event if you skip it. 


For TEXT (variable-length) events, you still have to read the size of the event, which is coded 


in the next byte(s) a bit like in MIDI files (but not inverted). After the size is the actual data, 
which you can process or skip. 

To get the size of the event, you've got to read bytes until the last one, which has bit 7 off (the 
purpose of this compression is to reduce the file size again). 


Start with a DWORD Size = 0. You're going to reconstruct the size by getting packs of 7 bits: 

1. Get a byte. 

2. Add the first 7 bits of this byte to Size. 

3. Check bit 7 (the last bit) of this byte. If it's on, go back to 1. to process the next byte. 
To resume, if Size < 128 then it will occupy only 1 byte, else if Size < 16384 it will occupy 
only 2 bytes & so on... 


So globally, you open the file, check the header, point to the data chunk & retrieve / filter all 
the events. 


Some constants 


header Format values 


FLP Format None =-1; // temporary 

FLP Format Song =0; // full project 

FLP Format Score =0x10; // score 

FLP Format Auto =FLP Format _Score+8; // automation 
FLP Format _ChanState =0x20; // channel 

FLP Format PlugState =0x30; // plugin 


FLP Format PlugState Gen=0x31; 
FLP Format PlugState FX =0x32; 


FLP Format _MixerState =0x40;  // mixer track 

FLP Format Patcher =0x50; // special: tells to Patcherize (internal) 

plugin flags 

Plug Visible =1; // editor is visible or not 

Plug Disabled =2; // obsolete 

Plug Detached =4; // editor is detached 

Plug Maximized =8; // editor is maximized 

Plug Generator =16; // plugin is a generator (can be loaded into a channel) 
Plug SD =32; // smart disable option is on 

Plug TP =64; // threaded processing option is on 

Plug Demo =128; // saved with a demo version 

Plug HideSettings =1<< 8; // editor is in compact mode 

Plug Captionized =1 <<9; // editor is captionized 

Plug DX =1 << 16; // indicates the plugin is a DirectX plugin (obsolete) 
Plug_EditorSize =2 << 16; // editor size is specified (obsolete) 

Plug EditorFlags =Plug_ Visible | Plug Detached | Plug Maximized | Plug HideSettings | 


Plug _Captionized; 


The events list 

Some events are obvious. Some others will have to be explained in details. But to understand 
how to process the file, you've got to know how the FLP is stored because the order of most 
of these events *IS* important. 


For example, when storing a channel, an FLP NewChan event is added. Then any next 
‘channel' event will affect this newly created channel. 


To spare some space, some events are stored only if they differ from their default value. 


// BYTE sized (0..63) 


FLP Byte =0; 
FLP ChanEnabled =0; 
FLP NoteOn 


FLP ChanVol 
FLP ChanPan 
FLP_MIDIChan 
FLP MIDINote 
FLP MIDIPatch 
FLP_MIDIBank 
FLP_ LoopActive 
FLP ShowlInfo 
FLP Shuffle =11; 
FLP MainVol 
FLP FitToSteps 
FLP Pitchable 
FLP Zipped 


FLP Delay Flags =16; 
FLP TimeSig Num =17; 
FLP TimeSig Beat =18; 
FLP UseLoopPoints =19; 


FLP LoopType 

FLP ChanType 

FLP TargetFXTrack =22; 
FLP PanVolTab 

FLP nStepsShown =24; 
FLP SSLength 

FLP SSLoop 

FLP FXProps 

FLP Registered 
FLP_APDC 

FLP TruncateClipNotes 
FLP EEAutoMode =31; 


// WORD sized (63..127) 
FLP Word =64; 
FLP NewChan 

FLP NewPat 

FLP Tempo 


// obsolete 


// obsolete 


=FLP Word; 
=FLP Word+1; 
=FLP Word+2; 


FLP CurrentPatNum=FLP Word+3; 


FLP PatData =FLP Word+4; 
FLP FX =FLP Word+5; 
FLP FXFlags =FLP Word+6; 
FLP FXCut =FLP Word+7; 
FLP DotVol =FLP Word+8; 
FLP DotPan =FLP Word+9; 


FLP FXPreamp 
FLP FXDecay 
FLP FXAttack 
FLP DotNote 
FLP DotPitch 
FLP DotMix 
FLP MainPitch 
FLP RandChan 
FLP MixChan 
FLP FXRes 
FLP OldSongLoopPos 
FLP FXStDel 
FLP FX3 

FLP DotFRes 
FLP DotFCut 
FLP ShiftTime 


=FLP Word+10; 
=FLP Word+11; 
FLP Word+12; 
FLP Word+13; 
=FLP Word+14; 
=FLP Word+15; 
=FLP Word+16; 
=FLP Word+17; 
=FLP Word+18; 


=FLP Word+19; 


=FLP Word+20; 


=FLP Word+21; 
=FLP Word+22; 


=FLP Word+23; 
=FLP Word+24; 
=FLP Word+25; 


// +pos 
// obsolete 
// obsolete 


// obsolete 
// obsolete byte version 
// obsolete 


// log vol & circular pan tables 
// +length 


// FlipY, ReverseStereo, etc 
// reg version 


// +PatNum (word) 
// obsolete, replaced by FLP_FineTempo 


// obsolete 
// obsolete 


// obsolete 


FLP LoopEndBar 
FLP Dot 

FLP_ DotShift 
FLP Tempo Fine 
FLP LayerChan 
FLP FXIcon 

FLP DotRel 

FLP SwingMix 


=FLP Word+26; 
=FLP Word+27; 
=FLP Word+28; 
=FLP Word+29; // obsolete, replaced by FLP FineTempo 
=FLP Word+30; 
=FLP Word+31; 
=FLP Word+32; 
=FLP Word+33; 


// DWORD sized (128..191) 


FLP Int 

FLP PluginColor 
FLP PLItem 

FLP Echo 

FLP FXSine 

FLP CutCutBy 
FLP WindowH 
FLP MiddleNote 
FLP Reserved 
FLP MainResCut 
FLP DelayFRes 
FLP Reverb 

FLP StretchTime 
FLP SSNote 
FLP FineTune 
FLP SampleFlags 
FLP LayerFlags 


=128; 
=FLP Int; 
=FLP Int+1; 
=FLP Int+2; 
=FLP Int+3; 
=FLP Int+4; 
=FLP Int+5; 
=FLP Int+7; 
=FLP Int+8; // may contain an invalid version info 
=FLP Int+9; // obsolete 
=FLP Int+10; 
=FLP Int+11; 
=FLP Int+12; 
=FLP Int+13; 
=FLP Int+14; 
=FLP Int+15; 
=FLP Int+16; 


// Pos (word) +PatNum (word) (obsolete) 


// SimSynth patch middle note (obsolete) 


FLP ChanFilterNum =FLP Int+17; 


FLP CurrentFilterNum 
FLP FXOutChanNum 
FLP NewTimeMarker 


FLP FXColor 
FLP PatColor 


FLP PatAutoMode 
FLP_ SongLoopPos 


FLP AUSmpRate 


FLP FXInChanNum =FLP Int+26; 


FLP PluginIcon 
FLP FineTempo 


=FLP Int+18; 
=FLP Int+19; 
=FLP Int+20; 
=FLP Int+21; 
=FLP Int+22; 
=FLP Int+23;  // obsolete 
=FLP Int+24; 

=FLP Int+25; 


// FX track output channel 
// + Time & Mode in higher bits 


// FX track input channel 
=FLP Int+27; 
=FLP Int+28; 


// Variable size (192..255) 


FLP Undef 
FLP Text 
AnsiString) 


FLP Text ChanName 
FLP Text PatName 


FLP Text Title 


FLP Text Comment 


=192; // +Length (VarLengthInt) 
=FLP Undef; // +Length (VarLengthInt) +Text (Null Term. 


=FLP_Text; // obsolete 
=FLP Text+1; 

=FLP Text+2; 
=FLP Text+3; 


FLP Text SampleFileName =FLP Text+4; 


FLP Text URL 


FLP Text CommentRTF 


FLP Version 
FLP RegName 
in the FLP 


FLP Text _DefPluginName 
//FLP_Text_ CommentRTF_SC 


(obsolete) 


FLP Text_ProjDataPath 
FLP Text PluginName 
FLP Text FXName 

FLP Text_TimeMarker 


FLP Text Genre 


=FLP Text+5; 
=FLP Text+6; // comments in Rich Text format 
=FLP Text+7; 
=FLP Text+8; // since 1.3.9 the (scrambled) reg name is stored 


=FLP Text+9; 
=FLP Text+10; //new comments in Rich Text format 


=FLP Text+10; 

=FLP_ Text+11; // plugin's name 

=FLP Text+12; // FX track name 

=FLP Text+13; // time marker name 
=FLP Text+14; 


FLP Text_Author 
FLP MIDICtrls 
FLP Delay 

FLP TS404Params 
FLP DelayLine 
FLP NewPlugin 
FLP PluginParams 
FLP Reserved2 
FLP ChanParams 
FLP CtrlRecChan 
FLP PLSel 

FLP Envelope 

FLP ChanLevels 
FLP ChanFilter 
FLP ChanPoly 

FLP NoteRecChan 


FLP PatCtrlRecChan 
FLP PatNoteRecChan 
FLP InitCtrlRecChan 
FLP RemoteCtrl_MIDI 
FLP RemoteCtrl_ Int 


FLP Tracking 


FLP ChanOfsLevels 
FLP Text _RemoteCtrlFormula 
FLP Text_ChanFilter 


FLP RegBlackList 
FLP PLRecChan 
FLP ChanAC 

FLP FXRouting 
FLP FXParams 
FLP_ ProjectTime 
FLP PLTrackInfo 


FLP Text _PLTrackName 


FLP Text+15; 
FLP Text+16; 
=FLP Text+17; 
=FLP Text+18; 
FLP_Text+19; // obsolete 
=FLP Text+20; // new VST or DirectX plugin 
=FLP Text+21; 
=FLP Text+22; // used once for testing 
=FLP Text+23; // block of various channel params (can grow) 
=FLP Text+24; // automated controller events 
=FLP Text+25; // selection in playlist 
=FLP Text+26; 
=FLP Text+27; // pan, vol, pitch, filter, filter type 
=FLP Text+28; // cut, res, type (obsolete) 
=FLP Text+29; // max poly, poly slide, monophonic 
=FLP Text+30; // automated note events 
=FLP Text+31; // automated ctrl events per pattern 
=FLP Text+32; // automated note events per pattern 
=FLP Text+33; // init values for automated events 
=FLP_ Text+34; // remote control entry (MIDI) 
=FLP_ Text+35; // remote control entry (internal) 
=FLP_ Text+36; // vol/kb tracking 
=FLP Text+37; // levels offset 
=FLP_ Text+38; // remote control entry formula 
=FLP Text+39; 
=FLP Text+40; // black list of reg codes 
=FLP Text+41; // playlist 
=FLP Text+42; // channel articulator 
=FLP Text+43; 
=FLP Text+44; 
=FLP Text+45; 
=FLP Text+46; 
=FLP Text+47; 


